Software User's Guide Version 3.4

Configuring and Monitoring the ESCON and Parallel Channel Adapters

This chapter describes the Enterprise Systems Connection (ESCON) and Parallel Channel Adapter configuration and operational commands. It contains the following sections:

For additional monitoring information, refer to Software User's Guide.
Note About Examples

Throughout this following sections there are examples of ESCON and PCA interface configurations. In areas where there is a significant difference between ESCON and PCA, there will be multiple examples.

Note About Examples
Throughout this following sections there are examples of ESCON and PCA interface configurations. In areas where there is a significant difference between ESCON and PCA, there will be multiple examples.

Accessing the Channel Interface

To access the channel adapter interface:

At the OPCON prompt, enter talk 6. For example:
```
* talk 6
  Config>
```
After you enter the talk 6 command, the CONFIG prompt (Config>) displays on the console. If the prompt does not appear, press Return again.
Enter the list devices command to display the network interface numbers that are currently configured.
Record the interface numbers.
Create a channel interface by either:
- Entering the add device esc command at the Config> prompt to create an ESCON channel.
```
  Config> add dev esc
  Device Slot x(1-8) 1?
  Adding ESCON Adapter device in slot 1 port 1 as interface x 
```
  Note: x is the assigned interface number.
  
  Note: The 2216 has eight slots, numbered 1 to 8.
- Entering the add device pca command at the Config> prompt.
```
  Config> add dev pca
  Device Slot x(1-8) 1?
  Adding PCA device in slot 1 port 1 as interface x
```
  Note: x is the assigned interface number.
  
  Note: The 2216 has eight slots, numbered 1 to 8.
Enter the network command and the number of the interface you obtained in step 4. For example, if interface 0 is an ESCON interface:
```
  Config> network 0
  ESCON Config>
```
The ESCON configuration prompt (ESCON Config>), is displayed.
Configure the channel adapter virtual net handlers and associated subchannels using the commands in Table 52.

Channel Adapter Configuration Commands

The following commands can be entered at a channel adapter configuration prompt (either ESC Config> or PCA Config>):

Table 52. Channel Interface Configuration Commands

Command Description
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
add Adds a virtual net handler for one of the base protocols or adds APPN loopback :

LCS - LAN Channel Station Support
LSA - Link Services Architecture
MPC+ - Multi-Path Channel+
APPN loopback

Each protocol provides a unique set of parameters which can be used to configure the virtual net handlers.
delete Deletes an interface on the channel adapter.
list Lists the channel adapter configuration and optionally lists subchannels. You can also list the transfer mode and channel transfer speed for a PCA.
mod Changes the configuration of an interface on the channel adapter.
set Sets the transfer mode and channel transfer speed for a parallel channel adapter (PCA).
Note: You can only access this command when configuring a PCA interface.

Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add virtual network handlers for LCS, LSA, and MPC+, and to enable loopback for APPN.

Syntax:

add: lcs
: lsa
: mpc
: appn loopback

Configuring an LCS Virtual Interface

Use the add lcs command to add an LCS virtual interface and get to the ESCON Add Virtual> or PCA Add Virtual> prompt from which you can enter other interface and subchannel parameters.
Note: Although LCS requires two subchannels, it is only necessary to specify one subchannel. An adjacent subchannel will be chosen such that the two subchannels will form a sequential pair with the write subchannel (device address is even) before the read subchannel (device address is odd).

After entering the add lcs, you will receive either the ESCON Add Virtual> or PCA Add Virtual> prompt. At this prompt you can enter the following commands:

Command

Description

acklen bytes

The size (in bytes) of acknowledgment frames over this interface.

Note:

The default value of 10 causes acknowledgment frames to be blocked. This value gives the best performance in heavy traffic networks if it is used with the default blktimer value. For IP interactive traffic and bulk data transfer, set acklen to 100.

Valid values: 1 to 500 bytes

Default value: 10

blktimer milliseconds

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Note:

The default value is set to give the best performance in heavy traffic networks. Set blktimer to 10 for IP interactive traffic and bulk data transfer.

Valid values: 1 to 20

Default value: 5

lantype type

LAN type, either Ethernet, Token Ring, or FDDI

Example: Specifying LAN Type for an LCS interface on an ESCON interface

ESCON Add Virtual>lan
Please select one of the following LAN types:
    E  Ethernet
    T  Token Ring
    F  FDDI
LCS LAN Type: [E]?

mac address

MAC Address of the virtual net handler

maxdata bytes

Maximum size of data handled by this virtual network handler.

Valid Values: 516 to 17749 for Token Ring, 1500 for Ethernet, 4478 for FDDI

Default: 2052 for Token Ring, 1500 for Ethernet, 4478 for FDDI

subchannels command

Places you at the next prompt based on the value of command. Command can be one of the following:

add
list
mod

See Configuring an LCS Subchannel for the commands you can enter at these prompts and their description.

enable 3172 emulation

Enables LCS Passthru to allow the device to function as a 3172 replacement in TCP/IP networks. When you enable 3172 emulation, you have the following menu available at the ESCON Add Virtual> command prompt:

ESCON Add Virtual>?
BLKtimer
ACKlen
SUBchannels
DISable 3172 Emulation
NET link
Exit
ESCON Add Virtual>

See "3172 Emulation Using LCS Passthru" for an example of 3172 emulation.

Configuring an LCS Subchannel

Entering subchannels command places you at the next prompt based on the value of command. Command can be one of the following:

add
list
mod
exit

Command

Description

add

Adds a subchannel pair and displays the ESCON Config LCS Subchannel> or PCA Config LCS Subchannel> prompt from which you can add Device Address, LPAR number, Link Address, and CU Logical Address.

Notes:

You only need to specify the device address for PCA interfaces.
You must add or configure one subchannel for an LCS virtual interface. Although LCS requires two subchannels, it is only necessary to specify one subchannel. An adjacent subchannel will be chosen such that the two subchannels will form a sequential pair with the write subchannel (device address is even) before the read subchannel (device address is odd).

device address

The unit address transmitted on the channel path to select a 2216 device. It is also referred to as subchannel number in S/370 I/O architecture. It is a two-digit hexadecimal value that can range from X'00' to X'FF'. This value is defined in the host IOCP by the UNITADD statement on the CNTLUNIT macro instruction for the real device.

Valid Values: X'00' to X'FF'

Default: None

Important

The following parameters do not apply for PCA.

lpar number

Important
The following parameters do not apply for PCA.

Logical partition number. This allows multiple logical host partitions (LPARs) to share one ESCON channel.

This value is defined in the host Input/Output Configuration Program (IOCP) by the RESOURCE macro instruction.

If the host is not using EMIF, use the default of 0 for the LPAR number.

Valid Values: X'0' - X'F'

Default: X'0'

link address

If one ESCON Director (ESCD) is in the communication path, the link address is the ESCD port number that is attached to the host.

If two ESCDs are in the path, it is the host-side port number of the ESCD defined with the dynamic connection.

When no ESCD is in the communication path, this value must be set to X'01'.

Valid Values: X'01' - X'0F'

Default: X'01'

cu address

The Control Unit address defined in the host for the 2216. This value is defined in the host Input/Output Configuration Program (IOCP) by the CUADD statement on the CNTLUNIT macro instruction.

Valid Values: X'0' - X'F'

Default: X'0'

Example: Adding a subchannel for an LCS interface for an ESCON interface

ESCON Add Virtual>sub add
Please add or configure one subchannel for an LCS virtual interface.
Although LCS requires two subchannels, it is only necessary to specify
one subchannel.  An adjacent subchannel will be chosen such that the two
subchannels will form a sequential pair with the write subchannel (device
address is even) before the read subchannel (device address is odd).
ESCON Config LCS Subchannel>d 4
ESCON Config LCS Subchannel>e

list

Lists information for the LCS subchannels.

Example: Listing subchannels for an ESCON LCS interface

ESCON Add Virtual>sub lis
          Read Subchannels:
          Sub  0   Device address   :  5   LPAR number        : 0
                   Link address     :  1   CU Logical Address : 0
          Write Subchannels:
          Sub  1   Device address   :  4   LPAR number        : 0
                   Link address     :  1   CU Logical Address : 0

Example: Listing subchannels for an PCA LCS interface

PCA Add Virtual>sub lis
          Read Subchannels:
          Sub  2   Device address   :  3
 
          Write Subchannels:
          Sub  3   Device address   :  2

mod

Modifies a configured LCS subchannel pair. It lists the configuration for the configured LCS subchannels and allows you to modify one of them by specifying the "sub" number from the list. Once you have selected the subchannel, you can change the device address, LPAR number, Link Address, and CU Logical Address as described in "Configuring an LCS Subchannel" .

Notes:

You can only change the device address for PCA.
For ESCON or PCA, if there is only one subchannel configured, you can only modify the subchannel, not delete it.

Configuring an LSA Virtual Interface

Use the add lsa command to add an LSA virtual interface and get to the ESCON Add Virtual> or PCA Add Virtual> prompt from which you can enter the following commands:

Command

Description

[enable or disable]

Enables or disables loopback on an LSA interface.

Note:

Only one of these parameters can be entered, depending on the state of the loopback function. If the loopback is disabled, you can enable it; if it is enabled, you can disable it.

Valid Values: enable or disable

Default: disable

acklen bytes

The size (in bytes) of acknowledgment frames over this interface.

Note:

The default value of 10 causes acknowledgment frames to be blocked. This value gives the best performance in heavy traffic networks if it is used with the default blktimer value. Set acklen to 100 for IP bulk data transfer and interactive traffic.

Valid values: 1 to 500 bytes

Default value: 10

blktimer milliseconds

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Note:

The default value is set to give the best performance in heavy traffic networks. Set blktimer to 10 for IP bulk data transfer and interactive traffic over Ethernet and token-ring LANs.

Valid values: 1 to 20

Default value: 10

lantype type

LAN type, either Ethernet, or Token-Ring.

mac address

A unique MAC address to identify this virtual interface. This parameter is available only when loopback is enabled. It is the MAC address of the LSA/VTAM side of the loopback connection. The MAC address of the APPN side of the loopback connection is specified using ADD APPN.

maxdata bytes

Maximum size of data handled by this virtual network handler.

Valid Values: 516 to 17749 for Token Ring, 1500 for Ethernet

Default: 2052 for Token Ring, 1500 for Ethernet

net interface#

This parameter is available only when loopback is disabled. It is used to indicate the LAN adapter over which this LSA net will communicate. The LAN adapter must have been previously configured and can only be Token-Ring, Ethernet (including emulated LANs), or FDDI.

subchannels

Places you at the next prompt based on the value of command. Command can be one of the following:

add
delete
list
mod

See Configuring an LSA Subchannel for the commands you can enter at these prompts and their description.

There are four types of LSA connections, as shown in Figure 26. They are:

The example shows adding two LSA interfaces. The first one uses loopback and the second one is a direct connection.

Example 1: Adding an ESCON LSA interface with loopback

ESCON Config>add lsa
ESCON Add Virtual>enable
Enabling loopback through network 2.
Please set the MAC address using the "MAC" command
ESCON Add Virtual>mac 40:00:00:00:22:16
ESCON Add Virtual>lan
Please select one of the following LAN types:
    E  Ethernet
    T  Token Ring
LSA LAN Type: [E]? e
ESCON Add Virtual>sub add
ESCON Add LSA Subchannel>link c5
ESCON Add LSA Subchannel>d 8
ESCON Add LSA Subchannel>e
ESCON Add Virtual>e
ESCON Config>list all
Net:  2   Protocol: LSA    LAN type: LSA Ethernet    LAN number:  0
          Maxdata: 1500
          Loopback is enabled.
          MAC address: 400000002216
          Block timer:    10 ms  ACK length:  10 bytes
          Sub  0   Dev addr:  8  LPAR: 0  Link addr: C5  CU addr: 0

Example 2: Adding a PCA LSA interface with direct connection

PCA Config>add lsa
PCA Add Virtual>net 0
PCA Add Virtual>sub add
PCA Add LSA Subchannel>d 7
PCA Add LSA Subchannel>e
PCA Add Virtual>e
PCA Config>list all
Net:  6   Protocol: LSA    LAN type: Token Ring      LAN number:  0
          Maxdata: 2052
          Loopback is not enabled.
          MAC address: Obtained from net 0
          Block timer:    10 ms  ACK length:  10 bytes
          Sub  0   Dev addr:  7
PCA Config>

Configuring an LSA Subchannel

Entering subchannels command places you at the next prompt based on the value of command. Command can be one of the following:

add
delete
list
mod
exit

Command

Description

add

Adds a subchannel and displays the ESCON Add LSA Subchannel> or PCA Add LSA Subchannel> prompt from which you can add:

device address

The unit address transmitted on the channel path to select a 2216 device. It is also referred to as subchannel number in S/370 I/O architecture. It is a two-digit hexadecimal value that may range from 00-FF. This value is defined in the host IOCP by the UNITADD statement on the CNTLUNIT macro instruction for the real device.

Valid Values: X'00' to X'FF'

Default: None

Important

The following parameters do not apply for PCA.

lpar number

Important
The following parameters do not apply for PCA.

Logical partition number. This allows multiple logical host partitions, (LPARs) to share one ESCON channel.

This value is defined in the host Input/Output Configuration Program (IOCP) by the RESOURCE macro instruction.

If the host is not using EMIF, use the default of 0 for the LPAR number.

Valid Values: X'0' - X'F'

Default: X'0'

link address

If one ESCON Director (ESCD) is in the communication path, the link address is the ESCD port number that is attached to the host.

If two ESCDs are in the path, it is the host-side port number of the ESCD defined with the dynamic connection.

When no ESCD is in the communication path, this value must be set to X'01'.

Valid Values: X'01' - X'FE'

Default: X'01'

cu address

The Control Unit address defined in the host for the 2216. This value is defined in the host Input/Output Configuration Program (IOCP) by the CUADD statement on the CNTLUNIT macro instruction.

Valid Values: X'0' - X'F'

Default: X'0'

Enter exit to return to the previous prompt.

Example: Adding a subchannel for an ESCON LSA interface

ESCON Add Virtual>sub add
ESCON Add LSA Subchannel>link f7
ESCON Add LSA Subchannel>device 0
ESCON Add LSA Subchannel>cu 0
ESCON Add LSA Subchannel>lpar 0
ESCON Add LSA Subchannel>exit

Example: Adding a subchannel for a PCA LSA interface

PCA Add Virtual>sub add
PCA Add LSA Subchannel>device 2
PCA Add LSA Subchannel>exit

delete

Deletes a configured LSA subchannel. It lists the configuration for the configured LSA subchannels and allows you to delete one of them by specifying the "sub" number from the list.

list

Lists information for the LSA subchannels.

Example: Listing subchannels for an ESCON LSA interface

ESCON Config Virtual>sub list
          Sub  0   Device address   : 42   LPAR number        : 0
                   Link address     : C5   CU Logical Address : 0
          Sub  1   Device address   : 43   LPAR number        : 0
                   Link address     : C5   CU Logical Address : 0
          Sub  2   Device address   : 44   LPAR number        : 0
                   Link address     : C5   CU Logical Address : 0

Example: Listing subchannels for a PCA LSA interface

PCA Config Virtual>sub list
          Sub  0   Device address   : B
          Sub  1   Device address   : 12
          Sub  2   Device address   : 10
          Sub  3   Device address   : A
          Sub  4   Device address   : C
          Sub  5   Device address   : E

mod

Modifies a configured LSA subchannel. It lists the configuration for the configured LSA subchannels and allows you to modify one of them by specifying the "sub" number from the list. Once you have selected the subchannel, you can change the device address, LPAR number, Link Address, and CU Logical Address as described in "Configuring an LSA Subchannel".

Notes:

You can only change the device address for PCA.
For ESCON or PCA, if there is only one subchannel configured, you can only modify the subchannel, not delete it.

Configuring an MPC+ Virtual Interface

Use the add mpc command to add an MPC+ virtual interface and get to the ESCON Add Virtual> or PCA Add Virtual> prompt from which you can enter other interface and subchannel parameters:

Command

Description

acklen bytes

The size (in bytes) of acknowledgment frames over this interface.

Note:

The default value of 10 causes acknowledgment frames to be blocked. This value gives the best performance in heavy traffic networks if it is used with the default blktimer value.

Valid values: 1 to 500 bytes

Default value: 10

blktimer milliseconds

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Note:

The default value is set to give the best performance in heavy traffic networks.

Valid values: 1 to 20

Default value: 5

disable_outbound protocol blocking

Prevents the MPC+ Group from blocking multiple protocol packets within a single MPC+ packet when sending data to the host.

Note:

This parameter affects UDP+ and TCP/IP traffic. Enabling this parameter gives better performance in heavy traffic networks. Enable is the default.

disable udp+ exclusive use

To undedicate the MPC+ interface to UDP+.

Notes:

This parameter applies to ESCON interfaces only.
This means that only HPDT UDP in the host will be able to establish a connection across this MPC+ Group. UDP+ can never share an MPC+ Group with other protocols (for example, APPN, TCP/IP).

enable_outbound protocol blocking

Enables the MPC+ Group to block multiple protocol packets within a single MPC+ packet when sending data to the host.

Note:

This parameter affects UDP+ and TCP/IP traffic. Enabling this parameter gives better performance in heavy traffic networks. Enable is the default.

enable udp+ exclusive use

To dedicate the MPC+ interface to UDP+.

Notes:

This parameter applies to ESCON interfaces only.
This means that only HPDT UDP in the host will be able to establish a connection across this MPC+ Group. UDP+ can never share an MPC+ Group with other protocols (for example, APPN, TCP/IP).

maxdata bytes

Maximum size of data handled by this virtual network handler.

Valid Values: 512 to 32 768

Default: 2 048

reply timeout milliseconds

Timer for XID2/Disconnect timeout in milliseconds.

Valid Values: 1 to 50 000

Default: 45 000

sequencing interval timer milliseconds

Sequencing Interval Timer in milliseconds.

Valid Values: 1 to 50 000

Default: 3000

subchannels

Places you at the next prompt based on the value of command. Command can be one of the following:

addr
addw
delete
list
mod
exit

See Configuring an MPC+ Subchannel for the commands you can enter and their description.

Configuring an MPC+ Subchannel

Note:

A subchannel defined as a read subchannel to VTAM is a write subchannel to the 2216 and a subchannel defined as a write subchannel to VTAM is a read subchannel to the 2216.

Entering subchannels command places you at the next prompt based on the value of command. Command can be one of the following:

addr
addw
delete
list
mod
exit

Commands

Description

addr

Adds a read subchannel and displays the ESCON Add MPC+ Read Subchannel> or PCA Add MPC+ Read Subchannel> prompt from which you can enter the following commands:

Command

Description

device address

The unit address transmitted on the channel path to select a 2216 device. It is also referred to as subchannel number in S/370 I/O architecture. It is a two-digit hexadecimal value that may range from 00-FF. This value is defined in the host IOCP by the UNITADD statement on the CNTLUNIT macro instruction for the real device.

Valid Values: X'00' to X'FF'

Default: None

Important

The following parameters do not apply for PCA.

lpar number

Important
The following parameters do not apply for PCA.

Logical partition number. This allows multiple logical host partitions, (LPARs) to share one ESCON channel.

This value is defined in the host Input/Output Configuration Program (IOCP) by the RESOURCE macro instruction.

If the host is not using EMIF, use the default of 0 for the logical partition number.

Valid Values: X'0' - X'F'

Default: X'0'

link address

If one ESCON Directors (ESCD) is in the communication path, the link address is the ESCD port number that is attached to the host.

If two ESCDs are in the path, it is the host-side port number of the ESCD defined with the dynamic connection.

When no ESCD is in the communication path, this value must be set to X'01'.

Valid Values: X'01' - X'FE'

Default: X'01'

cu address

The Control Unit address defined in the host for the 2216. This value is defined in the host Input/Output Configuration Program (IOCP) by the CUADD statement on the CNTLUNIT macro instruction.

Valid Values: X'0' - X'F'

Default: X'0'

Enter exit to return to the ESCON Add Virtual> prompt.

Example: Adding read subchannels for a PCA MPC+ interface

PCA Add Virtual>sub addr
PCA Add MPC+ Read Subchannel>d 8
PCA Add MPC+ Read Subchannel>e
PCA Add Virtual>sub addr
PCA Add MPC+ Read Subchannel>d 9
PCA Add MPC+ Read Subchannel>e

addw

Adds a write subchannel and displays the ESCON Add MPC+ Write Subchannel> or PCA Add MPC+ Write Subchannel> prompt from which you can enter the following commands:

Command

Description

device address

The unit address transmitted on the channel path to select a 2216 device. It is also referred to as subchannel number in S/370 I/O architecture. It is a two-digit hexadecimal value that may range from 00-FF. This value is defined in the host IOCP by the UNITADD statement on the CNTLUNIT macro instruction for the real device.

Valid Values: X'00' to X'FF'

Default: None

Important

The following parameters do not apply for PCA.

lpar number

Important
The following parameters do not apply for PCA.

Logical partition number. This allows multiple logical host partitions, (LPARs) to share one ESCON channel.

This value is defined in the host Input/Output Configuration Program (IOCP) by the RESOURCE macro instruction.

If the host is not using EMIF, use the default of 0 for the LPAR number.

Valid Values: X'0' - X'F'

Default: X'0'

link address

If one ESCON Director (ESCD) is in the communication path, the link address is the ESCD port number that is attached to the host.

If two ESCDs are in the path, it is the host-side port number of the ESCD defined with the dynamic connection.

When no ESCD is in the communication path, this value must be set to X'01'.

Valid Values: X'01' - X'FE'

Default: X'01'

cu address

The Control Unit address defined in the host for the 2216. This value is defined in the host Input/Output Configuration Program (IOCP) by the CUADD statement on the CNTLUNIT macro instruction.

The Control Unit Address must be unique for each logical partition defined on the same host.

Valid Values: X'0' - X'F'

Default: X'0'

Example: Adding write subchannels for an ESCON MPC+ interface

ESCON Add Virtual>sub addw
ESCON Add MPC+ Write Subchannel>d 10
ESCON Add MPC+ Write Subchannel>e
ESCON Add Virtual>sub addw
ESCON Add MPC+ Write Subchannel>d 11
ESCON Add MPC+ Write Subchannel>e

delete

Deletes a configured MPC+ subchannel. It lists the configuration for the configured MPC+ subchannels and allows you to delete one of them by specifying the "sub" number from the list.

list

Lists information for the MPC+ subchannels.

Example: Listing subchannels for an ESCON MPC+ interface

ESCON Add Virtual>sub lis
          Read Subchannels:
          Sub  0   Device address   :  8   LPAR number        : 0
                   Link address     :  1   CU Logical Address : 0
          Sub  1   Device address   :  9   LPAR number        : 0
                   Link address     :  1   CU Logical Address : 0
          Write Subchannels:
          Sub  2   Device address   : 10   LPAR number        : 0
                   Link address     :  1   CU Logical Address : 0
          Sub  3   Device address   : 11   LPAR number        : 0
                   Link address     :  1   CU Logical Address : 0

Example: Listing subchannels for a PCA MPC+ interface

PCA Add Virtual>sub lis
          Read Subchannels:
          Sub  0   Device address   : 12
          Sub  1   Device address   : 13
 
          Write Subchannels:
          Sub  2   Device address   : 14
          Sub  3   Device address   : 15

mod

Modifies a configured MPC+ subchannel. It lists the configuration for the configured MPC+ subchannels and allows you to modify one of them by specifying the "sub" number from the list. Once you have selected the subchannel, you can change the device address, LPAR number, Link Address, and CU Logical Address as described in "Configuring an MPC+ Subchannel" .

Note:

You can only change the device address for PCA.

Once you have returned to the previous prompt, you can list the entire MPC+ configuration as shown in the following example:

Example: Listing and changing an ESCON MPC+ configuration

ESCON Config>list all
Net:  1   Protocol: MPC+   LAN type: MPC+            LAN number:  0
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          MPC Group is for exclusive use of UDP+
          Outbound protocol data blocking is enabled
          Block timer:   5 ms    ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 40  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 41  LPAR: 0  Link addr: F5  CU addr: 0
 
Net:  2   Protocol: MPC+   LAN type: MPC+            LAN number:  1
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          Outbound protocol data blocking is enabled
          Block timer:   5 ms    ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 42  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 43  LPAR: 0  Link addr: F5  CU addr: 0
 
Net:  3   Protocol: MPC+   LAN type: MPC+            LAN number:  2
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          Outbound protocol data blocking is enabled
          Block timer:   5 ms    ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 44  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 45  LPAR: 0  Link addr: F5  CU addr: 0
 
ESCON Config>mod 3
ESCON Config Virtual>?
REply timeout
SEQuencing int timer
MAXdata
SUBchannels
Exit
ESCON Config Virtual>rep 3100
ESCON Config Virtual>exit
ESCON Config>list all
Net:  1   Protocol: MPC+   LAN type: MPC+            LAN number:  0
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          MPC Group is for exclusive use of UDP+
          Outbound protocol data blocking is enabled
          Block timer:   5 ms    ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 40  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 41  LPAR: 0  Link addr: F5  CU addr: 0
 
Net:  2   Protocol: MPC+   LAN type: MPC+            LAN number:  1
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          Outbound protocol data blocking is enabled
          Block timer:   5 ms    ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 42  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 43  LPAR: 0  Link addr: F5  CU addr: 0
 
Net:  3   Protocol: MPC+   LAN type: MPC+            LAN number:  2
          Maxdata: 2048
          Reply TO: 3100   Sequencing Interval Timer: 3000
          Outbound protocol data blocking is enabled
          Block timer:   5 ms    ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 44  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 45  LPAR: 0  Link addr: F5  CU addr: 0
 
ESCON Config>

Configuring APPN Loopback

Important: You only need to configure APPN loopback once for each physical 2216. If you configure APPN loopback on an ESCON channel, you do not need to enable it on a PCA channel in the same 2216.

Notes:

APPN loopback cannot be added unless loopback has been enabled on an LSA virtual net as described in "Configuring an LSA Virtual Interface".
You can only add APPN loopback once on a given IBM 2216.

Use the add appn command to add APPN loopback. You will get either the ESCON Add Virtual> or PCA Add Virtual> prompt where you can enter the following commands:

Commands: Description
lantype type: Ethernet or Token Ring
mac address: A unique MAC address to identify the APPN side of the loopback connection in the 2216. This address must be different from the MAC address given to the host (VTAM) side of the loopback connection when configuring the LSA interface.

Example: Adding APPN loopback to an ESCON interface

ESCON Config>add appn
ESCON Add Virtual>
ESCON Add Virtual>lan
Please select one of the following LAN types:
    E  Ethernet
    T  Token Ring
APPN LAN Type: [T]?
ESCON Add Virtual>mac
MAC address in 00:00:00:00:00:00 form [000000000000]?
     40:00:22:16:00:09
ESCON Add Virtual>e
ESCON Config>li all
Net:  9   Protocol: APPN Loopback   LAN type: Token-Ring/802.5
          APPN loopback MAC address: 400022160009
 
Net:  5   Protocol: LSA    LAN type: Token Ring           LAN number:  0
          Maxdata: 2052
          Loopback is enabled.
          MAC address: 400022160005
          Block timer:    10 ms  ACK length:  10 bytes
          Sub  0   Dev addr:  0  LPAR: 0  Link addr:  1  CU num: 0
 
Net:  6   Protocol: LSA    LAN type: Token Ring           LAN number:  1
          Maxdata: 2052
          Loopback is not enabled.
          MAC address: Obtained from net 3
          Block timer:    10 ms  ACK length:  10 bytes
          Sub  0   Dev addr:  1  LPAR: 0  Link addr:  1  CU num: 0
 
Net:  7   Protocol: LCS    LAN type: LCS Ethernet 802.3   LAN number:  0
          Maxdata: 1500
          MAC address: 400022160007
          Block timer:     5 ms  ACK length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr:  5  LPAR: 0  Link addr:  1  CU num: 0
          Write Subchannels:
          Sub  1   Dev addr:  4  LPAR: 0  Link addr:  1  CU num: 0
ESCON Config>e

Notes:

The APPN port would be configured on net 9 of the example.
Configure APPN link stations that will connect to VTAM over the ESCON channel to use the MAC address of the LSA net as the destination MAC address. Do not use the APPN loopback net for this purpose.
Any LSA nets connection to APPN must have the same LAN type as the APPN loopback net.

Delete

Use the delete command to delete an interface on the channel adapter. If you know the interface number you wish to delete, you can specify it; otherwise, if you do not enter an interface number, the configuration is listed and you will be prompted to enter an interface number.

Syntax:

delete: interface_number
: (no parameter)

interface_number

Deletes the configuration for the specified interface number.

(no parameters)

Lists the configured interfaces for the channel adapter and prompts you for the interface number you wish to delete.

Example: Deleting an interface (no parameters given)

PCA Config>del
 
Net:  5   Protocol: APPN Loopback   LAN type: Token-Ring/802.5
          APPN loopback MAC address: 400000000406
Net:  2   Protocol: LSA    LAN type: Token Ring      LAN number:  0
          Maxdata: 2052
          Loopback is enabled.
          MAC address: 400000000403
          Block Timer:   10 ms   ACK length:   10 bytes
Net:  3   Protocol: LSA    LAN type: Token Ring      LAN number:  1
          Maxdata: 2052
          Loopback is not enabled.
          MAC address: Obtained from net 1
          Block Timer:   10 ms   ACK length:   10 bytes
Net:  4   Protocol: MPC+   LAN type: MPC+            LAN number:  0
          Maxdata: 2048
          Reply TO: 3100   Sequencing Interval Timer: 3000
 
          Outbound protocol data blocking is enabled
          Block Timer:    5 ms   ACK length:   10 bytes
Virtual net number to delete: [2]? 3
Are you sure?(Yes or [No]): y

Mod

Use the mod command to modify a configured interface on the channel adapter. If you know the interface number you wish to modify, you can specify it; otherwise, if you do not enter an interface number, the configuration is listed and you will be prompted to enter an interface number.

Syntax:

modify: interface_number
: (no parameters)

interface_number

Modifies the configuration for the specified interface number.

(no parameters)

Lists the configured interfaces for the channel adapter and prompts you for the interface number you wish to modify.

Example:

ESCON Config> mod Net: 1 Protocol: MPC+ LAN type: MPC+ LAN number: 0 Maxdata: 2048 Reply TO: 45000 Sequencing Interval Timer: 3000 MPC Group is for exclusive use of UDP+ Outbound protocol data blocking is enabled Block timer: 5 ms ACK length: 10 bytes Net: 2 Protocol: MPC+ LAN type: MPC+ LAN number: 1 Maxdata: 2048 Reply TO: 45000 Sequencing Interval Timer: 3000 Outbound protocol data blocking is enabled Block timer: 5 ms ACK length: 10 bytes Virtual net number to configure: [1]? 2 ESCON Config Virtual> ? REply timeout SEQuencing int timer MAXdata SUBchannels Exit ESCON Config Virtual>re Reply Time Out (range 1-50000 milliseconds): [45000]? 30003 ESCON Config Virtual>sub list Read Subchannels: Sub 0 Device address : 7 LPAR number : 0 Link address : F4 CU Logical Address : 0 Write Subchannels: Sub 1 Device address : 6 LPAR number : 0 Link address : F4 CU Logical Address : 0 ESCON Config Virtual>sub addr ESCON Add MPC+ Read Subchannel> ? LINk address (ESCD Port) LPAR number CU logical address Device address Exit ESCON Add MPC+ Read Subchannel>d 5 ESCON Add MPC+ Read Subchannel>? e ESCON Config Virtual>sub list Read Subchannels: Sub 0 Device address : 7 LPAR number : 0 Link address : F4 CU Logical Address : 0 Sub 1 Device address : 5 LPAR number : 0 Link address : F4 CU Logical Address : 0 Write Subchannels: Sub 2 Device address : 6 LPAR number : 0 Link address : F4 CU Logical Address : 0 ESCON Config Virtual>sub ? ADDRead subchannel ADDWrite subchannel MODify subchannel DELete subchannel LIst subchannels ESCON Config Virtual>sub del Read Subchannels: Sub 0 Device address : 7 LPAR number : 0 Link address : F4 CU Logical Address : 0 Sub 1 Device address : 5 LPAR number : 0 Link address : F4 CU Logical Address : 0 Write Subchannels: Sub 2 Device address : 6 LPAR number : 0 Link address : F4 CU Logical Address : 0 Subchannel number to delete: [0]? 0 Are you sure?(Yes or [No]): y ESCON Config Virtual>sub list Read Subchannels: Sub 0 Device address : 5 LPAR number : 0 Link address : F4 CU Logical Address : 0 Write Subchannels: Sub 1 Device address : 6 LPAR number : 0 Link address : F4 CU Logical Address : 0

ESCON Config Virtual>sub mod Read Subchannels: Sub 0 Device address : 5 LPAR number : 0 Link address : F4 CU Logical Address : 0 Write Subchannels: Sub 1 Device address : 6 LPAR number : 0 Link address : F4 CU Logical Address : 0 Subchannel number to modify: [0]? 1 ESCON Modify MPC+ Subchannel>d 2 ESCON Modify MPC+ Subchannel>e ESCON Config Virtual>sub list Read Subchannels: Sub 0 Device address : 5 LPAR number : 0 Link address : F4 CU Logical Address : 0 Write Subchannels: Sub 1 Device address : 2 LPAR number : 0 Link address : F4 CU Logical Address : 0 ESCON Config Virtual> exit ESCON Config>

List (ESCON)

Use the list command to list the channel adapter configuration and also (with list all) list a subchannel summary.

Syntax:

list: (no parameters)
: all

(no parameters)

Lists the channel adapter configuration.

Example: Listing an ESCON configuration

ESCON Config>li
Net:  5   Protocol: LSA    LAN type: Token Ring           LAN number:  0
          Maxdata: 2052
          Loopback is enabled.
          MAC address: 400022160005
          Block timer:    10 ms  ACK length:  10 bytes

all

Lists the channel configuration with a subchannel summary. Three examples are provided. The first is for a channel adapter with LSA and LCS subchannels. The second is for a channel adapter with MPC+ subchannels. The third example show the results of 3172 Emulation.

Example for LSA and LCS: Listing an ESCON configuration with subchannel summary

ESCON Config>li all
Net:  2   Protocol: LCS    LAN type: LCS FDDI    LAN number:  0
          Maxdata: 4478
          MAC address: 400000002216
          Block Timer:  5 ms  ACK Length:  10 bytes
          Sub  0   Dev addr:  8  LPAR: 0  Link addr: C5  CU addr: 0
 
Net:  5   Protocol: LSA    LAN type: Token Ring           LAN number:  0
          Maxdata: 2052
          Loopback is enabled.
          MAC address: 400022160005
          Block timer:    10 ms  ACK length:  10 bytes
          Sub  0   Dev addr:  0  LPAR: 0  Link addr:  1  CU addr: 0

Example with 3172 Emulation enabled:

ESCON Config>list
Net:  5   Protocol: LCS    LAN type: Token Ring      LAN number:  0
          3172 Emulation is enabled.
          MAC address: Obtained from net 0
          Block Timer:    5 ms   ACK length:   10 bytes
ESCON Config>list all
Net:  5   Protocol: LCS    LAN type: Token Ring      LAN number:  0
          3172 Emulation is enabled.
          MAC address: Obtained from net 0
          Block Timer:    5 ms   ACK length:   10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 21  LPAR: 0  Link addr: F7  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 20  LPAR: 0  Link addr: F7  CU addr: 0
 
ESCON Config>

Example for MPC+: Listing an ESCON configuration with subchannel summary

Net:  1   Protocol: MPC+   LAN type: MPC+            LAN number:  0
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          MPC Group is for exclusive use of UDP+
          Outbound protocol data blocking is enabled
          Block Timer:  5 ms  ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 40  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 41  LPAR: 0  Link addr: F5  CU addr: 0
 
Net:  2   Protocol: MPC+   LAN type: MPC+            LAN number:  1
          Maxdata: 2048
          Reply TO: 45000   Sequencing Interval Timer: 3000
          Outbound protocol data blocking is enabled
          Block Timer:  5 ms  ACK Length:  10 bytes
          Read Subchannels:
          Sub  0   Dev addr: 42  LPAR: 0  Link addr: F5  CU addr: 0
          Write Subchannels:
          Sub  1   Dev addr: 43  LPAR: 0  Link addr: F5  CU addr: 0

List (PCA)

Use the list command to list the transfer mode and channel transfer speed configured or the virtual interfaces configured.

Syntax:

list: base
: virtual

base: Lists the transfer mode and channel transfer speed configured.
virtual [all or (no parameter)]: Lists a summary of the configuration for the virtual interfaces or the configuration of all virtual interfaces and their subchannels (all).

Set (PCA Only)

Use the set command to set the transfer mode and channel transfer speed for a parallel channel adapter (PCA).

Syntax:

set: tmode value

tmode value

Specifies the mode of transfer that the 2216 uses to transfer data to the host, either DC interlock or Data Streaming and the channel transfer speed when using data streaming.

Valid values:

D: Specifies Direct-coupled (DC) Interlock mode. This mode is the standard I/O interface that requires a response to a demand.
S: Specifies speeds less than or equal to a 3.0 MB data streaming mode.
S4: Specifies speeds less than or equal to a 4.5 MB data streaming mode.

Default value: D

Accessing the Channel Interface Monitoring Process

To access the ESCON or PCA interface:

At the OPCON prompt, enter talk 5. For example:
```
* talk 5
+
```

To display the monitoring prompt for the channel interface or any of the channel adapter's virtual interfaces, enter the network command followed by the interface number of the interface.

If you do not know the interface number, use the configuration command at the + prompt to display a list of interface numbers configured on the router.

Multiprotocol Access Services
 
2216-MAS Feature 2822 V3.2 Mod 0 PTF 0 RPQ 0 MAS.EF9 cc4_2a     
 
 
Num Name  Protocol
0   IP     DOD-IP
3   ARP    Address Resolution
11  SNMP   Simple Network Management Protocol
23  ASRT   Adaptive Source Routing Transparent Enhanced Bridge
28  APPN   Advanced Peer-to-Peer Networking [HPR]
29  NHRP   Next Hop Routing Protocol
30  APPN   Advanced Peer-to-Peer Networking [ISR]
 
Num Name  Feature
2   MCF    MAC Filtering
8   NDR    Network Dispatching Router
10  AUTH   Authentication
 
31 Networks:
Net Interface  MAC/Data-Link         Hardware                       State
 0   TKR/0      Token-Ring/802.5      Token-Ring                     Up
 1   Eth/0      Ethernet/IEEE 802.3   Ethernet                       Up
 2   PCA/0      Parallel Channel      Parallel Channel               Up
 3   LCS/0      LCS                   Parallel Channel               Up
 4   MPC/0      MPC                   Parallel Channel               Up
 5   LSA/0      LSA                   Parallel Channel               Up
 6   TKR/1      Token-Ring/802.5      APPN Loopback                  Up
 7   ESCON/0    ESCON                 ESCON Channel                  Up
 8   MPC/1      MPC                   ESCON Channel                  Up
 9   LCS/1      LCS                   ESCON Channel                  Up
 10  LSA/1      LSA                   ESCON Channel                  Up

Channel Interface Monitoring Commands

The following commands can be entered at the channel adapter monitoring prompt (ESCON> or PCA>):

Table 53. Channel Interface Monitoring Commands

Command Description
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List Lists subchannels or lists nets.
Net Lists a specific network interface.
Dump_adapter Non-disruptively takes a dump of the channel adapter's IRAM and DRAM.
HIDtrace For PCA only, toggle off and on the channel adapter's HID (i.e. AIB) trace.
Trace Turn off and on the various channel adapter microcode traces.
Tune Modify various base network handler parameters.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Description
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List	Lists subchannels or lists nets.
Net	Lists a specific network interface.
Dump_adapter	Non-disruptively takes a dump of the channel adapter's IRAM and DRAM.
HIDtrace	For PCA only, toggle off and on the channel adapter's HID (i.e. AIB) trace.
Trace	Turn off and on the various channel adapter microcode traces.
Tune	Modify various base network handler parameters.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to list all subchannels or to list all network interfaces. You can also list the speed of a PCA interface.

Syntax:

list: base (PCA only)
: nets
: subchannels

base

Lists the transfer mode and channel transfer speed of the channel adapter.

nets

Lists network interfaces.

Example: List networks

PCA>li ne
+ net 1
PCA Base Monitoring
PCA> li nets
Net: 2   Type: LSA   LAN Type: Token-Ring/802.5  LAN Number: 0
          Net state: Up
Net: 4   Type: LSA   LAN Type: Token-Ring/802.5  LAN Number: 1
          Net state: Up
Net: 5   Type: LCS   LAN Type: FDDI              LAN Number: 0
          Net state: Down

Type

Type of virtual interface: LCS, LSA, or MPC+

LAN Type

LAN type, either Token-Ring/802.5, Ethernet/802.3, Ethernet/V2, Ethernet or FDDI.

Note:

This field is not displayed for subchannels that are part of an MPC+ interface.

LAN Number

Interface number of the LAN

Note:

This field is not displayed for subchannels that are part of an MPC+ interface.

Group Number

The group number is used internally by the device to identify a virtual MPC+ net interface on the channel adapter.

Net State

State of the network: Up, Down, Disabled, Not Present, HW Mismatch, or Testing.

Up

Indicates that the link is up.

Down

Indicates that the link is down.

Disabled

Indicates that the operator has disabled the link.

Not Present

Indicates that the network interface's adapter is not present.

HW Mismatch

An adapter other than a channel adapter is located in the slot or the physical channel adapter installed is not the same type as the configured channel adapter.

Note: Only base nets will have the states "Not present" and "HW mismatch."

Testing

The system is attempting to determine if a network connection exists

subchannels

Lists subchannels

ESCON> li su
The following  subchannels are defined:
       Local address: 00    Device address: 00   CU Logical Address: 00
                            Link: C5    LPAR: 00
                            Type: LSA
                   The following lantypes/lannums are using this subchannel:
                                    LAN type: Token-Ring/802.5 LAN number: 0
       Local address: 01    Device address: DD   CU Logical Address: 0B
                            Link: 5C    LPAR: 02
                            Type: LSA
                   The following lantypes/lannums are using this subchannel:
                                    LAN type: Token-Ring/802.5 LAN number: 0
       Local address: 02    Device address: 07   CU Logical Address: 00
                            Link: C5    LPAR: 00
                            Type: LSA
                   The following lantypes/lannums are using this subchannel:
                                    LAN type: Token-Ring/802.5 LAN number: 1
       Local address: 03    Device address: 02   CU Logical Address: 00
                            Link: C5    LPAR: 00
                            Type: LCS
                   The following lantypes/lannums are using this subchannel:
                                    LAN type: FDDI             LAN number: 0
       Local address: 04    Device address: 03   CU Logical Address: 00
                            Link: C5    LPAR: 00
                            Type: LCS
                   The following lantypes/lannums are using this subchannel:
                                    LAN type: FDDI             LAN number: 0

Local Address

The subchannel address index used internally by the device.

Device Address

Note: CU Logical Address, Link Address, and LPAR are only displayed for ESCON adapters.

CU Logical Address

The Control Unit address defined in the host for the device. This value is defined in the host Input/Output Configuration Program (IOCP) by the CUADD statement on the CNTLUNIT macro instruction.

The Control Unit Address must be unique for each LPAR defined on the same host.

Link Address

If one ESCON Director (ESCD) is in the communication path, the link address is the ESCD port number that is attached to the host.

If two ESCDs are in the path, the link address is the host-side port number of the ESCD defined with the dynamic connection.

When no ESCD is in the communication path, this value must be set to 0x01.

LPAR

Logical partition number. This allows multiple partitions in a logically partitioned (LPAR) host to share one ESCON fiber.

This value is defined in the host Input/Output Configuration Program (IOCP) by the RESOURCE macro instruction.

If the host is not using EMIF, the LPAR number is 0 (zero).

Type

Type of virtual interface: LCS, LSA, or MPC+

LAN Type

LAN type, either Token-Ring/802.5, Ethernet/802.3, Ethernet/V2, Ethernet or FDDI.

Note:

This field is not displayed for subchannels that are part of an MPC+ interface.

LAN Number

Interface number of the LAN

Note:

This field is not displayed for subchannels that are part of an MPC+ interface.

Group Number

The group number is used internally by the device to identify a virtual MPC+ net interface on the channel adapter.

Net

Use the net command to get to the monitoring environment for one of the virtual interfaces as described in:

"Channel Adapter LCS Interface Monitoring Commands"
"Channel Adapter LSA Interface Monitoring Commands"
"Channel Adapter MPC+ Interface Monitoring Commands"

Syntax:

net: net_number

Dump_adapter

Use the dump_adapter command to non-disruptively dump the channel adapter's IRAM and DRAM.

Syntax:

dump_adapter

HIDTrace

For PCA only, use the hidtrace command to toggle off and on the channel adpater's HID(i.e. AIB) trace.

Syntax:

hidtrace

Trace

Use the trace command to turn off and on various channel adapter microcode traces.

Syntax:

trace: mask

mask

A valid trace mask.

Valid Values: X'0000' to X'FFFF'

Default Values: Will prompt for the input value
Note: X'FFFF' turns on all the traces. X'0000' turns off all the traces.

Tune

Use the tune command to modify various base network handler parameters.

Syntax:

tune: iplow
: opfair

iplow

The low water mark for flow control of the network handler's input queue. See the GWCON queue command for more details.

Valid Values: 0 to 255

Default Values: Will prompt for the input value
Note: The network handler must be down or disabled in order to update this field.

opfair

The fair level for the length of the network handler's output queue. See the GWCON queue command for more details.

Valid Values: 0 to 255

Default Values: Will prompt for the input value
Note: The network handler must be down or disabled in order to update this field.

Channel Adapter LCS Interface Monitoring Commands

The following commands can be entered at the LCS monitoring prompt (LCS>):

Table 54. Channel Adapter LCS Interface Monitoring Commands

Command Description
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List Lists subchannels or lists nets.
Tune Modify various LCS network handler parameters.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Description
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List	Lists subchannels or lists nets.
Tune	Modify various LCS network handler parameters.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to display information for an LCS interface.

Syntax:

list

Example:

LCS> list
LCS Virtual Adapter
LCS Information for Net 4
--- ----------- --- --- --
LAN Type: Token-Ring/802.5     LAN Number: 0
Local Read Subchannel number:  7
Local Write Subchannel number: 6
MAC Address: 400022160001
Local IP Address: 9.192.200.1
Tuning Information: ACKLEN= 10, BLKTIMER= 5     
Status: Down

Example with 3172 Emulation enabled

LCS> list
 
LCS Virtual Adapter
LCS Information for Net 5
--- ----------- --- --- --
LAN Type: Token-Ring           LAN Number: 0
Local Read Subchannel number:  1
Local Write Subchannel number: 0
MAC Address: 08005AFE0144
LCS 3172 Emulation to net 0
Tuning Information: ACKLEN= 10, BLKTIMER= 5     
Status: Down

LAN Type

LAN type, either Token-Ring/802.5, Ethernet/802.3, Ethernet/V2, Ethernet or FDDI.

Note:

This field is not displayed for subchannels that are part of an MPC+ interface.

LAN Number

Interface number of the LAN

Note:

This field is not displayed for subchannels that are part of an MPC+ interface.

Read Subchannel

The local subchannel from which the device receives data.

Write Subchannel

The local subchannel through which the device transmits data.

MAC Address

A unique MAC address to identify this virtual interface.

Local IP address

IP Address that was assigned to this network interface. If you have not configured an IP address, this line will not be displayed.

LCS Bridging

This is only displayed when bridging is configured. (Not shown in the example.)

Acklen

The size (in bytes) of acknowledgment frames over this network interface.

Blktimer

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Status

Status of the network: Up, Down, Disabled, Not Present, HW Mismatch, or Testing

Up

The network connection is established.

Down

The network connection can not be determined.

Disabled

Device is disabled and diagnostic testing can be performed

Not Present

Indicates that the network interface's adapter is not present.

HW Mismatch

An adapter other than a channel adapter is located in the slot or the physical channel adapter installed is not the same type as the configured channel adapter.

Note: Only base nets will have the states "Not present" and "HW mismatch."

Testing

The system is attempting to determine if a network connection exists

Tune

Use the tune command to modify various LCS network handler parameters.

Syntax:

tune: acklen
: blktimer

acklen

The size (in bytes) of acknowledgment frames over this LCS network interface.

Valid Values: 0 to 500

Default Values: Will prompt for the input value
Note: The base network handler with which the LCS network handler is associated must be up in order to modify this field.

blktimer

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Valid Values: 0 to 20

Default Values: Will prompt for the input value
Note: The base network handler with which the LCS network handler is associated must be up in order to modify this field.

Channel Adapter LSA Interface Monitoring Commands

The following commands can be entered at the LSA monitoring prompt (LSA>):

Table 55. Channel Adapter LSA Interface Monitoring Commands

Command Description
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List Lists information for adapters, SAPs, or link stations.
Tune Modify various LSA network handler parameters.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Description
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List	Lists information for adapters, SAPs, or link stations.
Tune	Modify various LSA network handler parameters.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to display information for adapters, SAPs, and link stations.

Syntax:

list: adapter
: sap
: link stations

adapter

Lists virtual adapters for LSA.

Example: List Virtual Adapter for LSA

LSA> list ad
LSA Virtual Adapter
LSA Information for Net 2
--- ----------- --- --- --
LAN Type: Token-Ring/802.5     LAN Number: 0
MAC Address: 4000000000CF
Downstream network: Loopback - Net 2
Tuning Information: ACKLEN= 10, BLKTIMER= 10 
Status: Host connected
 
#SAPs Open: 1     #Link Stations Open: 1
Maximum frame size: 2052 (0x804)
Host User ID                  Subchannel
------------                  ----------
  00000000                       0
 
1 host user(s)

Acklen: The size (in bytes) of acknowledgment frames over this network interface.
Blktimer: The maximum time (in milliseconds) to wait before sending an unfull data block to the host.
#SAPs Open: Number of SAPs opened by VTAM on this LSA interface
#Link Stations Open: Number of link stations open for all SAPs on this LSA interface
Maximum Frame Size: Maximum frame size supported over this LSA interface
Host User ID: A unique ID generated by VTAM to identify the host user on a given subchannel
Subchannel: The local subchannel being used by this host user.

sap

Lists Service Access Points (SAPS) for LSA

Example: List SAP for LSA

LSA> list sap
 SAP    Provider     User     Max Link    Open Link
Number   SAP ID     SAP ID    Stations    Stations
------  --------   --------   --------    ---------
  4    02000000   00000001      1           1
1 SAPs currently open

SAP Number: Identifies the SAP to LLC
Provider SAP ID: A unique ID generated by VTAM to identify this SAP
User SAP ID: A unique ID generated by device to identify this SAP
Max Link Stations: Maximum number of link stations VTAM can open on this SAP
Open Link Stations: Number of link stations currently open on this SAP

link

Lists link information for LSA

Example: List link for LSA

LSA> list link
Please specify a SAP number (0-236): [4]? 4
                 Link Stations on SAP 4
 
Station    Destination    Destination      Link     Frames      Frames
   ID      MAC Address    SAP Number      Status     Sent      Received
-------    -----------    -----------     ------    ------     --------
 
02000001   40000000ABCD        4         Connected        9            9
1 link station(s) open on SAP 4

Station ID: A unique ID generated by device to identify this link station
Destination MAC Address: MAC address of the remote LLC link station
Destination SAP Number: SAP value of the remote LLC link station
Link Status: Current status of the LLC connection
Frames Sent: Number of packets sent to VTAM for this link station
Frames Received: Number of packets received from VTAM for this link station

Tune

Use the tune command to modify various LSA network handler parameters.

Syntax:

tune: acklen
: blktimer

acklen

The size (in bytes) of acknowledgment frames over this LSA network interface.

Valid Values: 0 to 500

Default Values: Will prompt for the input value
Note: The base network handler with which the LSA network handler is associated must be up in order to modify this field.

blktimer

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Valid Values: 0 to 20

Default Values: Will prompt for the input value
Note: The base network handler with which the LSA network handler is associated must be up in order to modify this field.

Channel Adapter MPC+ Interface Monitoring Commands

The following commands can be entered at the MPC+ monitoring prompt (MPC+>):

Table 56. Channel MPC+ Interface Monitoring Commands

Command Description
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List Lists subchannels.
Tune Modify various MPC+ network handler parameters.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Description
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
List	Lists subchannels.
Tune	Modify various MPC+ network handler parameters.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to display the MPC+ Group, subchannels, Connection Manager (CM), and connection information.

Syntax: list: cm
: connection
: mpc group
: subchannel

cm

Shows information on the Connection Manager that is running on the MPC+ Group. The information shown is the group token, the type of connection manager, and the current state.

The states are:

Reset: The CM is currently inactive.
Pending Active-waiting for MPC+ Group: The underlying MPC+ Group is coming active.
Pending Active-waiting for this side: The other side has initiated bring-up of the CM but this side has not started to initiate bring-up of the CM.
Pending Active-waiting for other side: This side has initiated bring-up of the CM but the other side has not started to initiate bring-up of the CM.
Pending Active-callee: This side is waiting for the other side, which is the caller in this bring-up to start the call.
Pending Active-caller: This side has called out to the other side and is waiting for the other side to respond to the call.
Active: Active and usable

Example: List an active CM for MPC+

MPC+>li cm
MPC+ Connection Managers(CM)
              Group Token    type      state
------------------------- ------- ----------
 
090144953400000009            PTP Active

Example: List, no active CM for MPC+

MPC+>li cm
No CMs on this MPC+ Group

connection

Shows information on the connections running on the MPC+ Group/Connection Manager. The information shown is in two parts: the virtual circuit and the connections under the virtual circuit. The following information is shown for the virtual circuit: the local and remote virtual circuit tokens, the protocol type, and the current state.

Local Virtual Circuit Token

Token in the device representing this virtual circuit.

Remote Virtual Circuit Token

Token in the host representing this virtual circuit. This field is blank if not known.

Protocol

The upper layer protocol that this virtual circuit is using.

States for the Virtual Circuit

The states for the virtual circuit are:

Reset: The virtual circuit is currently inactive.
Active-other side: The other side is currently accepting calls (connections) for this virtual circuit.
Active-this side: This side is currently accepting calls (connections) for this virtual circuit.
Active-both sides: Both sides of the virtual circuit are accepting calls (connections) for this virtual circuit.
Not accepting new calls: This connection is not accepting new calls (connections). However, connections that are already running on the virtual circuit will stay up.

The information shown for the connection is the local and remote connection tokens and the current state. For IP protocols (that is, UDP+ and TCP/IP), the local and destination IP addresses associated with the connection will also be shown, if known.

Local Connection Token

The token in the device representing this connection.

Remote Connection Token

The token in the host representing this connection. This field is blank if not known.

States for the Connection

The states for the connection are:

Reset: The connection is currently inactive
Pending Active - callee: This side is about to respond to the call request from the other side.
Pending Active - caller: This side has called out to the other side and is waiting for the other side to response to the call.
Pending Active - awaiting datastart: The connection is waiting for both sides to be ready to start allowing user data to flow.
Active: Active and usable

Local IP address

The IP address on the MPC+ interface in the device that is associated with this connection. This field will be displayed only for IP protocols.

Destination IP Address

The IP address in the host that is associated with this connection. This field will be displayed only for IP protocols.

Example: List, active connections for MPC+

MPC+>li conn
MPC+ Connections
Virtual Circuit Token = 090144C22C0000000D
Remote Registration Token(s) = 05000101A5
Protocol =       APPN, State = Active-both sides
                        Local Connection Token = 090144C3300000000E
                        Remote Connection Token = 05000101A6
                        State =     Active
 
Protocol =     TCP/IP, State = Active-both sides
                        Local Connection Token = 090144C4400000000F
                        Remote Connection Token = 05000101B0
                        State =     Active
                        Local IP address = 100.0.0.1
                        Destination IP address = 100.0.0.2

Example: List, no connections active for MPC+

MPC+>li conn
No User Connections on this MPC+ Group

mpc

Displays information about the MPC+ Group. It displays the local and remote registration token, if known, and the current state of the MPC+ Group. Also, if the MPC+ is for the exclusive use of UDP+, that will be indicated. If the MPC+ Group is not for the exclusive use of UDP+, exclusive use will not be mentioned in the display.

Note:

UDP+ is not supported on a Parallel Channel Adapter (PCA).

Example:

MPC+>li mpc
MPC+ Group
Tuning Information: ACKLEN= 10, BLKTIMER= 5       
Local registration token = 0901422A3C00000000
Remote registration token = 050001019D
state = Active
This MPC+ Group is for the exclusive use of UDP+.
Outbound protocol data blocking is enabled for the MPC+ Group.

Acklen

The size (in bytes) of acknowledgment frames over this network interface.

Blktimer

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Local registration token

Token in the device representing this MPC+ Group.

Remote registration token

Token in the host representing this MPC+ Group. This field is blank if not known.

State

The state of the MPC+ Group:

Reset: The MPC+ Group is currently inactive.
Pending Active-xid2(00): In the process of becoming active and currently processing xid2(00)s.
Pending Active-xid2(07): In the process of becoming active and currently processing xid2(07)s.
Active: Active and usable.
Pending Reset: Pending inactive (in other words, in the process of coming down).

subchannel

Shows information about the subchannels that are part of the MPC+ Group. It shows the local subchannel number, logical partition number, Link address, Control Unit (CU) logical address, Device Address, type of Subchannel (READ or WRITE), and the current state of the subchannel. The type should be the opposite of what is configured at the host.

Example: List subchannels for MPC+

MPC+>li sub
MPC+ Subchannels
 Local         Link  CU Log.  Device
 number  LPAR  addr  address  address   type      state
 ------- ----- ----- ------   ------- ---------- ----------
 
      1     0    F4      0       9       READ     Active
      0     0    F4      0       8      WRITE     Active

Note:

Only device address is displayed when listing a PCA subchannel.

Local number

The subchannel address index used internally by the device.

Note: CU Logical Address, Link Address, and LPAR are only displayed for ESCON adapters.

LPAR

Logical partition number. This allows multiple partitions in a logically partitioned (LPAR) host to share one ESCON fiber.

This value is defined in the host Input/Output Configuration Program (IOCP) by the RESOURCE macro instruction.

If the host is not using EMIF, the LPAR number is 0 (zero).

Link Address

If one ESCON Director (ESCD) is in the communication path, the link address is the ESCD port number that is attached to the host.

If two ESCDs are in the path, the link address is the host-side port number of the ESCD defined with the dynamic connection.

When no ESCD is in the communication path, this value must be set to 0x01.

CU Logical Address

The Control Unit address defined in the host for the device. This value is defined in the host Input/Output Configuration Program (IOCP) by the CUADD statement on the CNTLUNIT macro instruction.

The Control Unit Address must be unique for each logical partition defined on the same host.

Device Address

The unit address transmitted on the channel path to select a device. It is also referred to as subchannel number in S/370 I/O architecture. It is a two-digit hexadecimal value that may range from X'00' to X'FF'. This value is defined in the host IOCP by the UNITADD statement on the CNTLUNIT macro instruction for the real device. It is a two-digit hexadecimal value that may range from X'00' to X'FF'. This value is defined in the host IOCP by the UNITADD statement on the CNTLUNIT macro instruction for the real device.

Type

Whether this is a read or write subchannel.

state

The state of the subchannel:

Reset: The subchannel is currently inactive.
Pending Active-xid2(00): The subchannel is becoming active and currently processing xid2(00)s.
Pending Active-xid2(07): The subchannel becoming active and currently processing xid2(07)s.
Active: The subchannel is active and part of an MPC+ Group.
Pending Reset: The subchannel is pending inactive (in other words, in the process of coming down).

Tune

Use the tune command to modify various MPC+ network handler parameters.

Syntax:

tune: acklen
: blktimer

acklen

The size (in bytes) of acknowledgment frames over this MPC+ network interface.

Valid Values: 0 to 500

Default Values: Will prompt for the input value
Note: The base network handler with which the MPC+ network handler is associated must be up in order to modify this field.

blktimer

The maximum time (in milliseconds) to wait before sending an unfull data block to the host.

Valid Values: 0 to 20

Default Values: Will prompt for the input value
Note: The base network handler with which the MPC+ network handler is associated must be up in order to modify this field.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]